Theme-Compliant Windows

Mac OS applications typically interact with users via windows on the screen. You can use the Window Manager to create, display, and manage the drawing and behavior of standard Mac OS windows. Dialog boxes and alert boxes are specific types of windows that are used to present information to and solicit information from the user. You can use the Dialog Manager to readily implement standard Mac OS dialog boxes and alert boxes. To be theme-compliant, your program should either use standard windows or use the Appearance Manager to adapt your custom window, dialog box, and alert box elements. For examples and descriptions of standard Mac OS 8. x windows, see the Mac OS 8 Human Interface Guidelines at

<http://developer.apple.com/techpubs/mac/HIGOS8Guide/thig-2.html>

The Appearance Manager provides the following functions for applying theme-compliant colors and patterns to custom windows:

SetThemeWindowBackground associates a theme-compliant color or pattern with the background of a window.
SetThemeTextColorForWindow sets a window's foreground color to a theme-compliant color.

The Appearance Manager provides the following functions for drawing theme-compliant custom windows:

DrawThemeModelessDialogFrame draws a beveled outline inside the content area of a modeless dialog box.
DrawThemeScrollBarDelimiters outlines a window's scroll bars.
DrawThemeStandaloneGrowBox draws a size box.
DrawThemeStandaloneNoGrowBox draws a fill image for use in the corner space between scroll bars.
DrawThemeTitleBarWidget draws a close box, zoom box, or collapse box.
DrawThemeWindowFrame draws a window frame.
DrawThemeWindowHeader draws a window header.
DrawThemeWindowListViewHeader draws a window list view header.

The Appearance Manager provides the following functions for obtaining window region information:

GetThemeStandaloneGrowBoxBounds obtains the bounds of a size box.
GetThemeWindowRegion obtains the specified window region.
GetThemeWindowRegionHit obtains the part of the window that the user clicked upon.